home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / ExtUtils::Installed.Z / ExtUtils::Installed
Encoding:
Text File  |  1998-10-28  |  5.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaalllllllleeee2222dddd3333((((////3333JJJJ))))uuuullll////99998888    ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttccccEEEEhhhhxxxxtttt0000UUUU2222tttt))))iiiillllssss::::::::IIIInnnnssssttttaaaalllllllleeeedddd((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       ExtUtils::Installed -    Inventory management of    installed
  10.       modules
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.          use ExtUtils::Installed;
  14.          my    ($inst)    = ExtUtils::Installed->new();
  15.          my    (@modules) = $inst->modules();
  16.          my    (@missing) = $inst->validate("DBI");
  17.          my    $all_files = $inst->files("DBI");
  18.          my    $files_below_usr_local = $inst->files("DBI", "all", "/usr/local");
  19.          my    $all_dirs = $inst->directories("DBI");
  20.          my    $dirs_below_usr_local =    $inst->directory_tree("DBI", "prog");
  21.          my    $packlist = $inst->packlist("DBI");
  22.  
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.       ExtUtils::Installed  provides    a standard way to find out
  26.       what core and    module files have been installed.  It uses the
  27.       information stored in    .packlist files    created    during
  28.       installation to provide this information.  In    addition it
  29.       provides facilities to classify the installed    files and to
  30.       extract directory information    from the .packlist files.
  31.  
  32.      UUUUSSSSAAAAGGGGEEEE
  33.       The _n_e_w() function searches for all the installed .packlists
  34.       on the system, and stores their contents. The    .packlists can
  35.       be queried with the functions    described below.
  36.  
  37.      FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  38.       new()
  39.            This takes no parameters, and searches for all the
  40.            installed .packlists on the system.  The    packlists are
  41.            read using the ExtUtils::packlist module.
  42.  
  43.       modules()
  44.            This returns a list of the names    of all the installed
  45.            modules.     The perl 'core' is given the special name
  46.            'Perl'.
  47.  
  48.       files()
  49.            This takes one mandatory    parameter, the name of a
  50.            module.    It returns a list of all the filenames from
  51.            the package.  To    obtain a list of core perl files, use
  52.            the module name 'Perl'.    Additional parameters are
  53.            allowed.     The first is one of the strings "prog", "man"
  54.            or "all", to select either just program files, just
  55.            manual files or all files.  The remaining parameters
  56.            are a list of directories. The filenames    returned will
  57.            be restricted to    those under the    specified directories.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaalllllllleeee2222dddd3333((((////3333JJJJ))))uuuullll////99998888    ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttccccEEEEhhhhxxxxtttt0000UUUU2222tttt))))iiiillllssss::::::::IIIInnnnssssttttaaaalllllllleeeedddd((((3333))))
  71.  
  72.  
  73.  
  74.       directories()
  75.            This takes one mandatory    parameter, the name of a
  76.            module.    It returns a list of all the directories from
  77.            the package.  Additional    parameters are allowed.     The
  78.            first is    one of the strings "prog", "man" or "all", to
  79.            select either just program directories, just manual
  80.            directories or all directories.    The remaining
  81.            parameters are a    list of    directories. The directories
  82.            returned    will be    restricted to those under the
  83.            specified directories.  This method returns only    the
  84.            leaf directories    that contain files from    the specified
  85.            module.
  86.  
  87.       directory_tree()
  88.            This is identical in operation to _d_i_r_e_c_t_o_r_y(), except
  89.            that it includes    all the    intermediate directories back
  90.            up to the specified directories.
  91.  
  92.       validate()
  93.            This takes one mandatory    parameter, the name of a
  94.            module.    It checks that all the files listed in the
  95.            modules .packlist actually exist, and returns a list of
  96.            any missing files.  If an optional second argument
  97.            which evaluates to true is given    any missing files will
  98.            be removed from the .packlist
  99.  
  100.       packlist()
  101.            This returns the    ExtUtils::Packlist object for the
  102.            specified module.
  103.  
  104.       version()
  105.            This returns the    version    number for the specified
  106.            module.
  107.  
  108.      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  109.       See the example in the _E_x_t_U_t_i_l_s::_P_a_c_k_l_i_s_t manpage.
  110.  
  111.      AAAAUUUUTTTTHHHHOOOORRRR
  112.       Alan Burlison    <Alan.Burlison@uk.sun.com>
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaalllllllleeee2222dddd3333((((////3333JJJJ))))uuuullll////99998888    ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttccccEEEEhhhhxxxxtttt0000UUUU2222tttt))))iiiillllssss::::::::IIIInnnnssssttttaaaalllllllleeeedddd((((3333))))
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      Page 3                        (printed 10/23/98)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.